home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr35 / grafd211.zip / GRAF-D.DOC < prev    next >
Text File  |  1993-05-27  |  10KB  |  195 lines
  1.     Program: GRAF-D v2.11
  2.      Author: Steve Catmull
  3.        Date: 05/27/93
  4.  
  5. DESCRIPTION 
  6. ========================================================================
  7.  
  8.                PPE (PCBoard Programming Executable) that you can replace
  9.                PCBTEXT record #149 with.  
  10.              
  11.                What this PPE offers that PCBoard does not is to do some 
  12.                checking for graphics capability before asking the caller 
  13.                if they want graphics or not.  
  14.               
  15.                By testing for graphics before the prompt is ever issued, 
  16.                the appropriate default value can be set for the user. If 
  17.                they have ANSI capabilities (as per the <esc>[6n test) 
  18.                then the default for the prompt will be "Yes". A test 
  19.                will also be made if they have RIPscrip capabilities (as 
  20.                per the <esc>[! test).  If neither of these are detected 
  21.                in the default wait period then the default will remain 
  22.                as no.
  23.  
  24.  
  25. INSTALLATION
  26. ========================================================================
  27.              
  28.                Installing this PPE is very simple.  Use MKPCBTXT to load 
  29.                your PCBTEXT file.  Press F3 and enter 149.  You will now 
  30.                see the "Do you want graphics" record.  Simply change it 
  31.                to an ! followed by the full path and filename to the 
  32.                ANSI-D.PPE file. 
  33.                
  34.                In addition, make sure that you have not told PCBoard 
  35.                that you want to default to graphics at login.  If you
  36.                do, GRAF-D will attempt to leave a message addressed to
  37.                the SysOp informing you that your system is improperly
  38.                configured.
  39.                 
  40.                That's all there is to it.
  41.  
  42.  
  43. COMMAND LINE PARAMETERS
  44. ========================================================================
  45.  
  46.                You can control the wait time for ANSI and RIP detection 
  47.                from the command line.  You may also choose to run this 
  48.                program in "compatible" mode via command line switches. 
  49.                The following details the command line options that are 
  50.                available.
  51.                 
  52.                   /WAIT:[clock ticks]
  53.  
  54.                      Gives you the ability to over-ride the default wait 
  55.                      time for graphics detection.  The default wait is 
  56.                      for 50 clock ticks which is equal to about 3 
  57.                      seconds (There are roughly 18.2 clock ticks per 
  58.                      second). For example, if you wish to make the new 
  59.                      wait time about 4 seconds, then you would enter the 
  60.                      following in PCBTEXT:
  61.                      
  62.                          C:\PCB\PPE\GRAF-D.PPE /WAIT:73
  63.                                        
  64.                   
  65.                   /COMPATIBLE
  66.  
  67.                      Because this PPE will change the "Do you want" 
  68.                      graphics prompt based on the graphics capability 
  69.                      detected then there is a good chance that login 
  70.                      scripts might fail.
  71.                      
  72.                      In other words, a user could login and receive
  73.                         
  74.                            "Do you want graphics (Enter)=no?"
  75.                            
  76.                      but the next time they login it may say
  77.                         
  78.                            "Do you want graphics (Enter)=yes?"
  79.                            
  80.                      Obviously, if the user has a script which checks 
  81.                      for "(Enter)=no" then their second login attempt 
  82.                      will fail.
  83.                      
  84.                      This command line switch will tell ANSI-D to report 
  85.                      the graphics mode detected above the "Do you want 
  86.                      graphics" prompt and explain that it will be the 
  87.                      default response.  The prompt will then be modified 
  88.                      to always display:
  89.                      
  90.                            "Do you want grpahics (Enter)=default?"
  91.                            
  92.                      It may break a few scripts initially, but once the 
  93.                      user has modified their end they can be assured 
  94.                      that they will always receive that prompt.  The 
  95.                      following is an example of how to specify this 
  96.                      parameter on the commandline:
  97.                      
  98.                      
  99.                          C:\PCB\PPE\GRAF-D.PPE /COMPATIBLE
  100.                          
  101.                   
  102.                   /AUTO
  103.  
  104.                      Some sysops may not want to give the user a choice 
  105.                      as to what graphics mode is selected.  If you are 
  106.                      one of these folks, then this switch is for you. 
  107.                      This switch will make the user use ANSI or RIP if 
  108.                      detected by the PPE.  If neither ANSI or RIP is 
  109.                      detected, then the user will be asked what graphics 
  110.                      mode they would like to use. 
  111.                      
  112.                      The reason that the PPE does not simply go with 
  113.                      non-graphics mode is because the user's 
  114.                      communication package may not properly handle the 
  115.                      ANSI auto-detection.  Example:
  116.                      
  117.                          C:\PCB\PPE\GRAF-D.PPE /AUTO
  118.                      
  119.            
  120.  
  121.  
  122. ERROR RATES
  123. ========================================================================
  124.                Not every user will have their graphics capabilities 
  125.                properly detected upon login.  If an invalid (or no 
  126.                response) at all is detetcted during the wait time then 
  127.                it must be assumed that the user does not have graphics 
  128.                capabilities.
  129.                
  130.                Some terminal programs are just plain slow in responding 
  131.                to ANSI or RIPscrip requests.  I have tested with the 
  132.                following communications software and all respond 
  133.                swiftly:
  134.                
  135.                    Telemate v4.x
  136.                    Telix v4.x
  137.                    Robocomm v4.x
  138.                    ProComm Plus v2.x
  139.                    Qmodem v4.31
  140.  
  141.                Even if you are using one of these programs it would 
  142.                still be likely for a response to not be detected.  This 
  143.                may happen if you are using error-correcting modems and 
  144.                the modem happens to be experiencing line noise.  In a 
  145.                case such as this, there is nothing that can be done.                   
  146.  
  147.                In my testing (about 1800 calls to Salt Air) I have seen 
  148.                that about 17% of all connections will fail to even get a 
  149.                response from the remote user.  Another 4% of all 
  150.                connections will fail due to incorrect responses from the 
  151.                remote terminal. This may happen if you start typing 
  152.                while graphics are being attempted to be detected.
  153.  
  154.                Of course, you could bump up the wait time to catch some 
  155.                of these connections.  The problem with this thinking 
  156.                though, is that users who truly do not have graphics 
  157.                capabilities will *have* to wait for the wait period (a 
  158.                default of about 3 seconds).  Extending that time any 
  159.                longer may really cause you to have some upset callers.
  160.  
  161.                For your reference, the following report shows the statistics
  162.                for the 1800 or so calls that I talked about previously:
  163.  
  164.                
  165.                                                  +-- Number of 
  166.                                                  |   calls where
  167.                                                  |   no response   + Incomplete    
  168.                                                  |   was recorded  | responses
  169.                                                  |                 |
  170.     *************************************************************************
  171.     Report ran: 05-07-93 08:24:53
  172.  
  173.        <= 2400 : Calls: 69   Average ticks: 17  Exc: 8   Inv: 7  Inc: 2 
  174.      2400-9600 : Calls: 153  Average ticks: 12  Exc: 43  Inv: 12 Inc: 1 
  175.     9601-14400 : Calls: 1101 Average ticks: 13  Exc: 245 Inv: 68 Inc: 13
  176.         14400+ : Calls: 150  Average ticks: 15  Exc: 13  Inv: 1  Inc: 5 
  177.     *************************************************************************
  178.         |         |               |                      |
  179.  Baud---+         +-- Number      +-- Average            |
  180.                       of              clock ticks        +- Invalid
  181.                       calls           elapsed               responses
  182.                                       before a
  183.                                       response
  184.  
  185.                                       
  186. MODIFYING SOURCE
  187. ========================================================================
  188.                
  189.                Feel free to modify the PPS (source) file as your needs 
  190.                dictate.  That is why the source is included.  :-)
  191.                
  192.                Last, but certainly not least.   HAVE FUN!
  193.  
  194.  
  195.